home *** CD-ROM | disk | FTP | other *** search
/ Power CD-ROM!! 8 / Power CD-ROM 8.iso / dos / maxfnd31 / maxfind.doc < prev    next >
Encoding:
Text File  |  1994-11-14  |  38.6 KB  |  863 lines

  1.  
  2.  
  3.             Manual for MAXFIND   Version 3.1.
  4.  
  5.                 Copyright 1989, 1994  Stanley C. Peters  All Rights Reserved
  6.  
  7.                 From:   Stanley C. Peters        Shareware $15, $6 s&h
  8.                         P. O. Box 2028    
  9.                         Fairfield, Iowa    52556
  10.  
  11.    Note: At this place in the document, many authors place their 
  12.          COMMERCIAL which goes on for pages. Just let me say:
  13.           - This program is shareware, it is not "free". It is a
  14.             "state of the art" product. If you use it regularly, 
  15.             you should register.  Business and Governmnent usage 
  16.             requires registration.
  17.           - When you register, you get more programs (see page 13).
  18.           - You can CHARGE it calling an 800 number (see page 15).
  19.  
  20.    TABLE OF CONTENTS.
  21.  
  22.       OVERVIEW  .......................................... 1
  23.       USING THE PROGRAM    ............................... 2
  24.       REFERENCE SECTION  ................................. 3
  25.          String specification  ........................... 3
  26.             Special characters  .......................... 3
  27.             Fuzzy spelling  .............................. 3
  28.          File specification  ............................. 4
  29.             Filelists  ................................... 4
  30.          Scope  .......................................... 4
  31.             Windows  ..................................... 4
  32.             Paragraphs  .................................. 5
  33.             Document  .................................... 5
  34.          Options  ........................................ 6
  35.          Customizing  .................................... 8
  36.             Environment variable  ........................ 8
  37.             Color selection  ............................. 8
  38.       SEARCH STRATEGIES BY TYPE OF FILE  ................. 9
  39.          Name and Address Lists  ......................... 9
  40.          Phone lists  .................................... 9
  41.          Letters  ........................................ 9
  42.          Text file searches  ............................. 9
  43.          Cataloging diskettes  ........................... 9
  44.          E-Mail  .........................................10
  45.          BBS files  ......................................10
  46.          Shakespeare  ....................................10
  47.          The BIBLE  ......................................10
  48.          Program files  ..................................11
  49.          General Hints  ..................................11
  50.     What's New with MAXFIND  ............................ 12
  51.     Files in the distribution  .......................... 12
  52.     Warranty  ........................................... 12
  53.     Supplemental programs for registered users  ......... 13
  54.     License  ............................................ 14
  55.     Support  ............................................ 14
  56.     Distribution  ....................................... 14
  57.     Registration and order form ......................... 15
  58.     Credit card registration  ........................... 15
  59.  
  60.  MaxFind 3.1                                             Page - 1
  61.  
  62. OVERVIEW.
  63.  
  64.     Basically, this program works much like other FIND programs that
  65.     you may have used.  Enter the program name at the DOS prompt,
  66.     followed by a string, and then the file name.  
  67.  
  68.     But, finding text can be frustrating.  This program offers several
  69.     strategies to aid searches.  One might look at it as a TOOLKIT to
  70.     allow customized searches for data. But there are
  71.     several powerful advantages:
  72.  
  73.           - Search for up to 15 strings on one pass over the file with
  74.             little performance penalty.
  75.  
  76.           - Combination and/or/not searches are definable in an easy 
  77.             to use way. 
  78.  
  79.           - Output text is color highlighted, with user options.
  80.  
  81.           - A scan size option for matching and display (1 to 15 lines). 
  82.             Great for Name and Address lists and for finding phrases 
  83.             or quotes that span more than one line.  
  84.  
  85.           - Can specify that the scope be a paragraph with alternate 
  86.             paragraph definition for many types of files, e.g., E-mail,
  87.             the Bible, BBS file lists.
  88.  
  89.           - Will search subdirectories or the entire disk.
  90.  
  91.           - Has a "fuzzy" search, spelling need not be exact.
  92.         
  93.           - A help screen is available, enter  mf  <ENTER> at the DOS prompt.
  94.         
  95.           - It works quickly!  Now, with Version 3.1, searches with
  96.             a 386/40, 400k per second (from ramdisk, 900k per second).
  97.  
  98.           - It is useful on word processors documents and data bases that 
  99.             keep their data in an ASCII format.
  100.  
  101.         The overall effect of this combination of features is a text
  102.         search program, that in the words of PC magazine (1/31/89),
  103.         "..holds its own with the best commercial programs."   
  104.  
  105.           
  106.  MaxFind 3.1                                             Page - 2
  107.  
  108.   USING THE PROGRAM:
  109.  
  110.     The program works from the DOS prompt much like the DOS FIND
  111.     command.  Enter the program name ( mf ), followed by a string,
  112.     and complete with a file name to be searched:
  113.         mf  microsoft  phone.fil
  114.  
  115.   SPECIFYING STRINGS:
  116.  
  117.     You can include up to 15 strings.  MAXFIND will search for all of 
  118.     the strings in parallel, reading the file once.  For example:
  119.           mf   gateway   microsoft   borland    phone.fil
  120.  
  121.     searches for three words in file 'phone.fil'.    
  122.  
  123.          [ Advanced options using non printable characters, NOT, and
  124.            fuzzy spelling are discussed in the Reference section. ]
  125.  
  126.     If you use the AND option ( -a ),  all the strings on the line 
  127.     must be present. Consider this:
  128.        mf   -a   bob   smith     address.fil 
  129.  
  130.     This searches for a line that contains bob and smith.
  131.  
  132.     But what if the name in the file is Robert Smith? The slash is
  133.     used to separate equivalent names so:
  134.        mf  -a  bob/robert  smith  address.fil -a
  135.  
  136.     would find Bob Smith and Robert Smith.  Or, adding Robt:
  137.        mf bob/robert/robt   smith   address.fil  -a 
  138.  
  139.     Sometimes you may want to see surrounding text for the find or
  140.     perhaps robert and smith are on different lines.  So you can expand
  141.     the scope of search (and display) by using a number to indicate
  142.     that you want more text to be considered at one time.  Consider:
  143.       mf  -5  -a bob/robert/robt   smith   address.fil 
  144.  
  145.     This would show 2 lines above and below the matching line[s].
  146.  
  147.         [ For a more sophisticated "paragraph" scope for things as 
  148.           E-mail, BBS files, the BIBLE ......   See below.    ]
  149.       
  150.   SPECIFYING FILENAMES:    
  151.  
  152.     MAXFIND follows the DOS rules for ambiguous file names (afns).
  153.     It uses the "?" and "*" as DOS does.  The "?" means "anything is ok"
  154.     for this position.  The * means anything is OK up to the period
  155.     or the end of the name.  So  "oct*.ltr" selects all files with a 
  156.     extension (suffix) of "ltr", where the name part starts with 
  157.     "oct".  Suppose you want to search a group of memos to find a 
  158.     delinquent note to Mr. Jones.  You could use this:
  159.        mf  jones delinquent    *.ltr  
  160.  
  161.         [ MaxFind will also search subdirectories beneath the one
  162.           specified and will accept a filelist.  See below.    ]
  163.  
  164.   REFERENCE SECTION                                           Page - 3  
  165.  
  166.   
  167.   STRING SPECIFICATION
  168.     
  169.     On occasion, a simple string is not enough. These options are available:
  170.  
  171.       -c    Case sensitivity - MaxFind ignores the case of the string 
  172.             unless you use the (-c) option to make case important.
  173.  
  174.       " "   Quotes are not needed when you define a string unless the string
  175.             contains blanks or DOS "piping" characters ( < > | ) such as:
  176.                mf "x < 10"   "x<10"   my.bas
  177.  
  178.        !    NOT option - if you want to prevent a match for a particular 
  179.               string, start the word with an exclimation point ! . Using
  180.             !never as a string prevent the text from being displayed.
  181.             Use this:
  182.                 mf  !once  !twice  infile  >outfile
  183.             to copy a infile deleting the lines with the words "once"
  184.             or "twice".
  185.  
  186.        ~    If you are not quite sure of the spelling, you can use the 
  187.             tilde (~) in the string, it stands for any character.  So
  188.             'g~ve' will find 'give' and 'gave'.  If you want to search for
  189.             the tilde, make it the last (or only) character in the string
  190.             or use the \nn option below.
  191.  
  192.       ^     Use the caret ^ as the first character to match only if the 
  193.             word starts in column one of the line.
  194.  
  195.       \nn   If you are searching for text that starts has a ~, !, or ^, 
  196.             or other problem characters, you can use  \nnn  where nnn is 
  197.             the decimal equivalent, e.g.:
  198.                    ^    \94                             !    \33
  199.                    ~    \126                            -    \45
  200.                   TAB   \9                              ,    \44
  201.                    ;    \59                             =    \61
  202.             If you want to search for the sequence !^ do this:
  203.                  mf  \33\94  filename
  204.             The numbers 0, 10, and 13 are used internally by MaxFind and 
  205.             cannot be used in this way.
  206.             If you are using a batch file, the comma, semicolon, TAB, 
  207.             and = sign will be ignored, so use the above equivalents.
  208.     
  209.    FUZZY SEARCH:
  210.  
  211.     This option allows you to search when you don't know the exact 
  212.     spelling of the word.  
  213.  
  214.     The technique used is inspired by the Soundex algorithm invented 
  215.     about 70 years ago to search name files.  Names that sound alike 
  216.     should have the same Soundex number.  It uses these rules:
  217.         - Vowels are ignored.
  218.         - Consonants that sound alike in a pronounced name are given 
  219.           the same "number".
  220.         - Successive consonants with the same number are counted as one
  221.           ( Willitt  is equal to Wilith).
  222.  
  223.  MaxFind 3.1                                             Page - 4
  224.  
  225.     All of which is interesting, but you don't have to worry about 
  226.     computing the numbers - it's done internally by MAXFIND. Only 
  227.     the first letter need be correct. If your unsure of that, try 
  228.     both ways:
  229.        mf -a -f  karl/carl smith   filename.txt
  230.     Accented vowels (International Characters) are treated like any
  231.     other vowel (they are ignored).
  232.  
  233.     If you input "herc", it matches "character" and "horse".  Notice
  234.     that, ignoring vowels and word boundaries, "character" has the
  235.     embedded sequence "hrc", just as "herc" does, so it matches.  In
  236.     the case of "horse", s and c sound alike, so we again have a match.
  237.  
  238.     Using fuzzy search alone can give many false hits.  Combining 
  239.     it with other search options will help a lot:
  240.        - Adding the case sensitive option (c) is effective when searching
  241.          for names, where the first letter of the name is capitalized:
  242.              mf Susan Somers    *.ltr     -fc
  243.  
  244.  
  245.   FILE SPECIFICATION
  246.  
  247.     MaxFind uses DOS filenames and wildcard conventions and it also 
  248.     offers more. You can search the whole disk or a subtree by using
  249.     the -s option. This will search the directory you named and 
  250.     subdirectories below it. Since you can start at the root directory 
  251.     of the disk, you can search the whole disk. Or you can be more 
  252.     selective by using filelists.
  253.    
  254.   FILELISTS
  255.  
  256.     You can also specify a file that contains a list of file names.  If
  257.     the filename starts with an @, MaxFind assumes that the file contains a
  258.     list of files, one per line.  The filenames in this file can have
  259.     wildcards, but not another @.  Suppose you want to search the JAN
  260.     and FEB directories for the letter.  Make a file named MONTHS that
  261.     contains these two lines:
  262.           c:\jan\*.ltr
  263.           c:\feb\*.ltr
  264.     Then, at the DOS prompt enter this:
  265.          mf -a jones delinquent  @months
  266.  
  267.     and both directories will be searched.  This feature allows you to
  268.     be more selective and to set the sequence of searches.
  269.  
  270.  
  271.   SCOPE
  272.  
  273.    WINDOWS:
  274.  
  275.     If you enter a number ( 2 - 15 ), a "window" slides down your data
  276.     files seeking matches within this span of lines.  Then it displays
  277.     the window, adding a "+-+" to separate the data.  At times, you may
  278.     see a set with fewer lines.  Look just above, to see the text that
  279.     completes your request.
  280.  
  281.  MaxFind 3.1                                             Page - 5
  282.  
  283.    PARAGRAPHS:
  284.  
  285.     You can set the span of a search to be a paragraph, where all 
  286.     strings must occur in one paragraph, and the paragraph will 
  287.     be displayed. Paragraphs can be defined three ways:
  288.        -p       A blank line. The p option invokes paragraph scope
  289.                 searching using blank lines to define the paragraph.
  290.        -po      Outdent. Several types of information use a hanging 
  291.                 outdent, where the first line starts to the left of the
  292.                 following lines.  BBS file lists use this format.  This
  293.                 option assumes the lead line will start in column 1. 
  294.                 You can use a digit to select the lead column:
  295.                       -po3
  296.                 indicates that the lead line starts in column 3 with 
  297.                 following lines starting in column 4 or more.
  298.        -psTEXT  String. Use a specific string to define paragraph 
  299.                 breaks. This can be very useful for computer output 
  300.                 which often has regularities. For example, I save some BBS 
  301.                 messages and I noticed that the first line of each message
  302.                 contains " bbs:". So this:
  303.                    mf -psbbs: gravis savemail 
  304.  
  305.                 sets the scope to be a bbs message, and shows those messages
  306.                 that contain "gravis".  (The TEXT should be in quotes
  307.                 if it contains any blanks.) 
  308.                 Or better yet:
  309.                    mf -ps"^ bbs:"  gravis savemail
  310.  
  311.                 indicating that the first five characters on the line are
  312.                 " bbs:". 
  313.  
  314.      If a paragraph is more than 8000 characters, it will be truncated.
  315.  
  316.    DOCUMENT
  317.  
  318.      This option ( -d ) is useful for searching many short documents. 
  319.      It uses an AND search, when all search criteria has been met, the
  320.      last occurrence of each string will be shown.  In effect, the size
  321.      of the window is the size of the document, but only the "hits"
  322.      will be shown.
  323.  
  324.  MaxFind 3.1                                             Page - 6
  325.  
  326.   OPTIONS:
  327.  
  328.     MaxFind has many options.  Use a minus sign to indicate them.  They
  329.     may occur after the program name and they may also be the right
  330.     most term(s).  These are all identical in action:
  331.  
  332.         mf -a  string1   string2  my.fil  -c
  333.         mf -ac  string1  string2  my.fil
  334.         mf  string1  string2      my.fil    -ac
  335.         mf  string1  string2      my.fil   -a  -c
  336.  
  337.     Feel free to enter "mf" at the DOS prompt to get help, I do.  This
  338.     will appear on your screen:
  339.  
  340.   Usage:  mf  [-options] string  [string].... [@]filename [-options]            
  341.       1 to 15 strings.  A tilde (~) matches any character, ^ line start.        
  342.       Filename may contain ?, *.  @ - filename is list of files.                
  343.     Searching options:                                                          
  344.       a - 'and', all must be present.  f - "fuzzy", approximate spelling.       
  345.       c - case sensitive search.       w - match only if a word.                
  346.       d - Stop on first match.         ! - NOT this string (if first letter).   
  347.     Output options:                                                             
  348.       l - show line numbers.           t - to screen and > file.                
  349.       n - no pause each 24 lines.      u - Unix (grep) style output.            
  350.     Input options:                                                              
  351.       b - also search binary files.    s, r - also include subdirectories        
  352.       h - strip hi (8) bits.           L    - limit to 80 char. lines.          
  353.     SIZE options, span for searching and display (default is one line).         
  354.       2 - 15  Window size (# of lines at a time.)                               
  355.       p - paragraph        po[nn]  - paragraph outdent, col nn or before        
  356.       psTEXT - paragraph, start defined by string TEXT                          
  357.     
  358.  
  359.   Options:
  360.  
  361.          a - 'and', all must be present.    
  362.             All the strings on the command line must be present.
  363.             You can use the / symbol to get and/or combinations.
  364.  
  365.          b - also search binary files.      
  366.             MAXFIND normally bypasses files that don't appear to be 
  367.             text files.  If you want it to search all specified files,
  368.             use this option.  You may have to use this option to 
  369.             search some word processing document files.  If your input 
  370.             filename is an ARC, COM, EXE, or BIN file, binary is 
  371.             assumed and this switch need not be entered.
  372.  
  373.          c - case sensitive search.         
  374.             The default is to ignore case.  Use this option to restrict
  375.             your output.  If you combine this with the fuzzy option,
  376.             case is checked only on the first letter of your input word.
  377.  MaxFind 3.1                                             Page - 7
  378.  
  379.          d - Span entire document, if necessary.
  380.             This option is particularly useful if you want to scan
  381.             many documents for the presence of a set of words.  It
  382.             uses an AND search, when all search criteria has been
  383.             met, the last occurrence of each string will be shown. 
  384.             In effect, the size of the window is the size of the
  385.             document, but only the "hits" will be shown.
  386.  
  387.          f - fuzzy search, accept approximate spelling.
  388.             Find even if the words are spelled differently.  Generally,
  389.             you should use this with the 'word' option, i.e., '-fw'.
  390.  
  391.          h - strip hi (8) bits.
  392.             Enter this option if you want the hi bit stripped before 
  393.             comparison and output.  Use this option if you are
  394.             scanning word processor documents (Wordstar, and perhaps
  395.             others).
  396.  
  397.          l - show line numbers.
  398.             Use this to show line numbers on each output line.  For a "normal"
  399.             ASCII file this should agree with the lines in your document.
  400.             MAXFIND advances this count when it detects a CRLF, CR alone,
  401.             or LF alone.  Or when 80 characters have passed without any of the 
  402.             above.  
  403.  
  404.          L - limit input line length to 80.
  405.             MaxFind normally uses the input file line length.  This
  406.             option breaks the lines into 80 byte lines.  This option
  407.             may be needed for non-ASCII files such as database, word
  408.             processing documents, and binary files.  Try it.  You may
  409.             want to increase the span count at the same time.
  410.  
  411. 3.1                                                      Page - 8
  412.  
  413.          n - no page pause.
  414.             Normally Maxfind pauses every 25 lines to let you scan
  415.             the screen.  This option delivers lines continuously,
  416.             without the need to press a key at each screen full.
  417.  
  418.          t - Sends output to both the screen and a redirected ( > ) file.
  419.             When you add redirection (e.g., >myfile ) to the command 
  420.             line, DOS sends what would normally have gone to the 
  421.             screen to a file and there would be little or no screen 
  422.             output.  This option allow you to capture the results to
  423.             a file and see the action on the screen.
  424.  
  425.          u - Unix (grep) style output.
  426.             This produces less screen output.  Each line will be
  427.             prefixed with the name of the file containing the string. 
  428.             The messages for file being searched, ie "+- filename>"
  429.             will not appear.  Nor will the "hex file skipped" message
  430.             appear.
  431.  
  432.  MaxFind 3.1                                             Page - 8  
  433.  
  434.          w - match only if a word.
  435.             A string will match only if the preceding and following
  436.             positions does not contain an alpha or numeric character. 
  437.             If used with the fuzzy (-f), only the left edge of the
  438.             word is checked.
  439.  
  440.  
  441.          a number (from 2 thru 15)
  442.             If you enter a number MAXFIND will to two things:
  443.             -  It will search for a match within a span of lines, that 
  444.                  is, all arguments need not occur on the same line.
  445.             -  When it finds a match, MAXFIND will show it centered in the 
  446.                  number of lines you have specified.  The set of lines 
  447.                  will be follow by this line: "+-+".
  448.             The text is displayed with little added "ornamentation"
  449.             and may not be clear at first glance.  If you use the
  450.             line numbers option (see above) for a while to gain
  451.             familiarity with the style.
  452.  
  453.  
  454.   
  455.   CUSTOMIZING
  456.   
  457.    ENVIRONMENT VARIABLE
  458.  
  459.     MaxFind can be customized using an environment variable.  By
  460.     "setting" a variable MAXFIND you can change the default options and
  461.     the output screen colors.  Instead of specifying your favorite
  462.     option every time you start the program, you can put that option
  463.     into an environment variable.  Most of the MaxFind options are
  464.     2-way switches, and they toggle - specify -l to show line numbers
  465.     in the Environment and also on the command line, and you have
  466.     turned the switch on, then off.  If you want to not pause at each
  467.     full screen and show line numbers on the output, put this line in
  468.     your autoexec.bat:
  469.         set MAXFIND=ln
  470.     Then if you don't want to see the line numbers sometimes,
  471.     enter: 
  472.         mf -l jones myfile
  473.    
  474.    COLORS
  475.  
  476.     You can also choose the colors for output highlighting with the MAXFIND
  477.     environment variable. The first position of the variable must 
  478.     be an upper case C, followed by digits. There are two options:
  479.       - If there is only one digit and it is 0, highlighting is turned off.
  480.       - If the C is followed by 6 digits, they are interpreted this way:
  481.          the first pair are background and foreground colors for normal text
  482.          the second pair are background and foreground colors for hits
  483.          the third pair are background and foreground colors for messages
  484.            such as "+- searching"
  485.     
  486.        the digits have this meaning:
  487.          0 - black
  488.          1 - blue
  489.          2 - green
  490.          4 - red.
  491.        They can be added ( 7 is white, all colors ).
  492.  
  493.  MaxFind 3.1                                             Page - 9
  494.  
  495. APPENDIX A.         SEARCH STRATEGIES BY FILE TYPE:
  496.  
  497.   Name and Address Lists:
  498.  
  499.      This is an easy type of file to search.  It is just what the
  500.      Soundex creators had in mind.  Use fuzzy and AND:
  501.          mf name1 surname  address.fil     -fa
  502.  
  503.      Since names should be words, we can add "w", so use:   -faw.
  504.      If name is always a capitalized word, add case, "c":   -fwac.
  505.      If we want to see surrounding lines, or add the State
  506.        to our search, add a number to get a window:         -fwac5.
  507.  
  508.   Phone Lists:
  509.  
  510.      With fon.bat:  "mf %1 %2 %3 %4 %5 %6  @c:\util\fonlists"
  511.      where FONLISTS contains these filenames (one per line):
  512.           C:\info\myfon    E:\net\mywork.fon    C:\info\*.fon  
  513.      you can search the files in a specified sequence.
  514.  
  515.   Letters:
  516.     
  517.      Letters are short documents.  Often we just want to know the DOS
  518.      filename of the letter.  Document mode "d" is appropriate.  This
  519.      will just show one matching line for each string we supply:
  520.          mf  name1  name2  topic1 topic2     c:letters\*.* -d 
  521.  
  522.   Text files:
  523.  
  524.     Here the important thing would be to search for a set of words and 
  525.     to show the surrounding context.  With a two file editor, tee 
  526.     would allow us to capture the text for inclusion in another file.
  527.     Fuzzy word may also be helpful:
  528.        mf  string1  string2  string3   *.ref -7atfw >mf$$$
  529.  
  530.     If you then bring the file up in your editor, you can quickly "cut
  531.     and paste" any desired text to another document.  Or if you simply 
  532.     want to know the names of documents to edit, use the -d option.   
  533.  
  534.   Cataloging diskettes:
  535.  
  536.     If you label your diskettes, internally and externally, use the
  537.     DOS DIR command to build up a catalog (catl):
  538.        dir  a:  >>catl
  539.     Then this batch file will show you the files and their volumes:
  540.       mf volume %1 %2 %3 %4 %5 %6  catl | mf -psvolume %1 %2 %3 %4 %5 %6
  541.  
  542.   Word Processing documents:
  543.     
  544.     I suggest using a window of at least two line and, if necessary,
  545.     adjusting the input options ( -L and -b ).
  546.  
  547.  MaxFind 3.1                                             Page - 10
  548.   E-MAIL:
  549.  
  550.     This discussion refers to the QWK  e-mail system used by many 
  551.     bulletin boards and works very well for saved messages. One of the 
  552.     first lines in each message starts with " BBS:", so let that be the 
  553.     paragraph defining string and set up a mail.bat.:
  554.        mf  -ps"^ BBS:"  %1 %2 %3 %4 %5 %6 %7 %8  c:\savemail\msg*.*
  555.     Then to retrieve messages from Kulman about serial cards just enter:
  556.        mail -a kulman serial
  557.  
  558.     I noticed that I was retaining messages for months, and that some of 
  559.     them were from ForSale conferences (#13 and #350). To keep the good
  560.     messages and discard the old ForSale messages, I did this:
  561.        mf -ps"^ BBS:"  "!conf: (13"  "!conf: (350"   msgs.old  >msgs.new
  562.  
  563.     
  564.   BBS files:
  565.     
  566.     Many BBSes have a file[s] that describe the files available for
  567.     download. They have multi-lines with the first line starting in 
  568.     column 1. My inspiration for the paragraph outdent option (-po).
  569.  
  570.     Some older Bulletin Boards have a file that contains one line
  571.     summary descriptions of the files available for downloading.  So
  572.     they are quite difficult to search.  An easy example:
  573.          mf line/word count space.fil -a
  574.  
  575.     to find a program to count words or lines.
  576.  
  577.     Others get harder to find.  Here the speed of searching will 
  578.     permit you to make repeated tries.  For example, I knew there was a
  579.     program which would list the disk drive table in the AT BIOS, but
  580.     I forgot its name.  This succeeded:
  581.             mf   list/display   bios/drive/table  space.fil -a
  582.  
  583.     I found the file I wanted.  In fact, I got nine "hits", and found
  584.     another two files that dealt with the same topic.
  585.  
  586.     Session log and history files are computer generated and have some 
  587.     very useful regularities.  TELIX can produce a usage log and this:
  588.            mf elapsed "++ at" connected   telix.use  >calls
  589.  
  590.     yields a list of When, Who, and How long - useful when looking at 
  591.     your phone bill.  
  592.  
  593.  
  594.   Shakespeare:
  595.     
  596.     The plays that I have seen are outdent files with the speaker's
  597.     name in column 1.  So use the -po option.
  598.  
  599.   The BIBLE:
  600.  
  601.     One set of files that I have seen use a special character
  602.     with the numeric value of 31 to separate the verses.  To search for 
  603.     Bible verses use  -ps\31 as the paragraph defining string.
  604.  MaxFind 3.1                                             Page - 11
  605.  
  606.   Program files:
  607.      
  608.     Maxfind can be very useful to programmers.  Allowing multiple
  609.     strings can give an instant cross reference for several labels. 
  610.     Using the word, -w option, searching for 'eof' will yield 'eof'
  611.     but not 'sizeof'.  Or get a cross reference on x, y, and z. 
  612.  
  613.     I comment all my function declarations starting with '/*f'.  Then
  614.     "mf //*f *.c -ul" gives me a "by module" index to the functions
  615.     with their line numbers.  Using this one line batch file (mfc.bat):
  616.         mf -u //*f %1 %2 %3 %4 %5 %6 %7 *.c | mf -ps/*f %1 %2 %3 %4 %5 %6 %7 
  617.     I can get a cross reference by function, e.g.:
  618.         mfc   alloc(   free(    LinkList
  619.     shows me which functions manage memory.  Or finding where idx changed:
  620.         mf "idx =/idx=/+idx/-idx/idx-/idx+"  *.c  -u        OR
  621.         mf "%1 =/%1=/++%1/--%1/%1--/%1++"  *.c  -u
  622.  
  623.  
  624.  
  625.  General Hints:
  626.  
  627.     Word processing documents generally have few line ends and
  628.     you may have to use the -L option to break the text into 
  629.     lines. Then you may want to use -a2 or -a3 to expand MAXFIND's
  630.     scope.
  631.  
  632.     If you want to search for the /, enter the / twice, the double
  633.     slash (//) indicates to MAXFIND that this is not an "or".  So if
  634.     you want to search for the date 10/12/85, enter 10//12//85.
  635.  
  636.     You could use -a2 to search for a phrase that starts on one line 
  637.     and completes on the next.  To find "in the course of time" use:
  638.         mf -a2 course  time     my.fil
  639.  
  640.  MaxFind 3.1                                             Page - 12
  641.  
  642. What's New with MAXFIND version 3.1:
  643.      Bug fix: In paragraph mode, if last paragraph of a file is a hit,
  644.               the first paragraph of the next file is always selected.
  645.  
  646. What's New with MAXFIND version 3.0:
  647.  
  648.      Major upgrade:
  649.          Paragraph scope with three options.
  650.          Color on output shows hits.
  651.          Faster (on a 386/40, from ramdisk, 900k per second).
  652.          Filenames to be searched can be in a filelist.
  653.          Etc......
  654.  
  655. What's New with MAXFIND version 2.0:
  656.  
  657.      For the common case, searching for one word within one line,
  658.         the program is 40% faster.  (more than 75k bytes per second at 8 mz)
  659.      Expanded discussion of usage with BBS files.
  660.        
  661. Whats New with MAXFIND version 1.0:
  662.  
  663.      The program name has been changed.  It was SPFIND (SPFND4.ARC).
  664.      Fuzzy search for approximate spelling searches.
  665.  
  666.     Files in the distribution:
  667.         MF.EXE          The program.
  668.         FILE_ID.DIZ     Short pgm description.
  669.         MAXFIND.DOC     Program documentation.
  670.         WHATSNEW.MF     What's new with this release with brief instructions.
  671.  
  672.        
  673. WARRANTY.
  674.      
  675.     MAXFIND is distributed on an "AS IS" basis without warranty,
  676.     expressed or implied.  Considerable testing effort has been
  677.     expended, but the user is advised to check the program's
  678.     suitability before relying on it.  The user assumes full risk as
  679.     to the results of using this program.  Any liability of the
  680.     author will be limited exclusively to product replacement.  In no
  681.     event shall the author be liable for any consequential damages
  682.     arising from the use, or inability to use this program.
  683.  
  684.  MaxFind 3.1                                             Page - 13
  685.  
  686.  
  687.   WHAT YOU GET
  688.  
  689.     If you register for $21, you will receive a disk with the current
  690.     version of MaxFind and additional programs.  These include other
  691.     shareware and freeware I have written and some utilities to convert
  692.     text files to a MaxFind paragraph format.
  693.  
  694.    Disk Navigator - a shareware DOS directory shell:
  695.       -  It has excellent, easily customized point and shoot macros, 
  696.          e.g., collect tagged files into a zip file with one keystroke.
  697.       -  Accepts command line arguments at program startup, 
  698.          including  *a*f*n*  type wildcards.  Also select a set
  699.          of directories you want shown together. This makes it a 
  700.          very capable "whereis" program. 
  701.       -  It can produce a [@]filename file acceptable to MaxFind
  702.          from a set of tagged files.
  703.       -  Registration is $19 plus $6 s&h. $30 will get you a disk and
  704.          registration of MaxFind and Disk Navigator.
  705.    
  706.    Texrep - This is a freeware text search and replace for files with 
  707.          a simple DOS command line syntax, for example:
  708.              texrep -w  old:new  Stan:STANLEY  Peters:PETERS  myfile.doc
  709.          will make my name upper case and change 'old' to 'new' with 
  710.          "myfile.do0" as output. To remove ctrl-z and CR, enter:
  711.              texrep  \26:  \13\10:\10  myfile
  712.  
  713.    Lildir - Another freeware program. A directory program ala DOS's DIR.
  714.          This one has 12 options (1 to 5 columns, walk the 
  715.          directory tree, ...) and you can customize to your favorite 
  716.          style with an environment variable.
  717.  
  718.    Epmode - This is a freeware printer setup program. My Panasonic is 
  719.          Epson compatible and about as easy to program as a VCR. 
  720.          Epmode has 26 options in an easy to use way.  Most
  721.          printers (including lasers) accept these.  My autoexec
  722.          has this line:
  723.              epmode  r  t4  c96  a 
  724.          This resets the printer, sets tabs every 4, selects
  725.          draft elite and the alternate graphic characters so that 
  726.          boxes on the screen print as boxes.
  727.  
  728.    PERUSE - A scrollback program that allows you to recall lines that have 
  729.          scrolled off the screen.  This TSR will loadhigh and uses
  730.          extended memory so that no low memory is used.  Very useful
  731.          with MaxFind and other command line programs. A PC-Mag utility.
  732.  
  733.     I am also building some utility programs to help make "paragraph" style
  734.     data files.  These are not shareware and are available free on the
  735.     disk I send to registered users.  I welcome your suggestions on
  736.     extending this suite.  So far, I can send:
  737.       - A pair of programs to extract the FILE_ID.DIZ information 
  738.         and build a BBS style list of ZIP files. 
  739.       - A program to collect small ASCII files into a single 
  740.         "paragraph file" saving the filename, time, and date.
  741.     These can use the [@]filename functions from MaxFind.
  742.     
  743.  MaxFind 3.1                                             Page - 14
  744.  
  745. LICENSE.
  746.  
  747.     MAXFIND is a copyrighted software that is being distributed as
  748.     shareware.  It is NOT in the public domain.  By using or
  749.     distributing this package, you agree to the conditions presented
  750.     herein.
  751.      
  752.     You may use MAXFIND for your own personal use.  If you find it
  753.     useful, you are requested to pay a Registration fee of $15.  You
  754.     may use the program on multiple machines.  Where there is the
  755.     potential for use on multiple machines at the same time, pay for
  756.     additional copies.  
  757.     
  758.     If you are using MAXFIND in a commercial, professional,
  759.     educational, or governmental organization, you are granted a
  760.     limited license, valid for thirty days, to use this package for
  761.     evaluation purposes; if you continue to use this package, you
  762.     must pay the registration fee.  Operators of bulletin board
  763.     systems that offer public domain programs are exempted from
  764.     payment.
  765.  
  766.     MaxFind is an original piece of work with considerable research
  767.     and development behind it. 
  768.  
  769.     The idea of shareware with its low cost distribution of quality
  770.     programs is an American Treasure.  Individuals with good ideas can
  771.     afford to implement them.  The authors are talented people that may
  772.     forego salary to implement their ideas.  A survey has indicated
  773.     that a very low percentage of users supply support.  Support those
  774.     that you use regularly.
  775.  
  776.   SUPPORT:
  777.    I will check regularly for messages on MAXFIND on:
  778.       Compuserve,                               my id: 76525,1601
  779.    I can also be contacted at:    
  780.       Internet                                   peters@miu.edu
  781.       Space BBS, Menlo Park   415 323 4197,       my id: Stan Peters
  782.  
  783.    My phone is 515-472-0696. 
  784.       It is best to call between 8pm and 10pm, weeknights. There is an 
  785.       answering machine on that line, any returned calls will be 
  786.       collect. Please, no calls after 10pm.
  787.       
  788.  
  789.   DISTRIBUTION.                        
  790.     
  791.     You may freely copy this program for friends so long as the four
  792.     files are included unmodified.  Non-profit user groups and bulletin
  793.     boards may also include it in their libraries.
  794.  
  795.     For-profit organizations may distribute it provided there is a
  796.     PROMINENT statement urging users to support the user supported
  797.     concept.  In no case may the cost per disk exceed $6.50.  It is OK
  798.     to put MaxFind on a public domain or Shareware diskette that
  799.     contains primarily textual material such as the Bible, a sports
  800.     database, or other reference material so long as the four files
  801.     are included unmodified and it is clear that the user has not paid
  802.     for MaxFind.
  803.  
  804.  MaxFind 3.1                                             Page - 15
  805.           
  806.                      REGISTRATION AND ORDER FORM 
  807.           
  808.           Stan Peters
  809.           P. O. Box 2028    
  810.           Fairfield, Iowa    52556
  811.           ---------------------------------------------------------------
  812.                                                    PRICE       PRICE
  813.           PRODUCT                         QTY      EACH       EXTENDED
  814.           -----------------------------   ---      -----      -------- 
  815.           MAXFIND  v. 3.1                 ___      $15.00     $_______
  816.  
  817.           For Registered users:
  818.               Disk with current version  
  819.                and other programs                   $6.00     $_______
  820.           
  821.                                                   SUBTOTAL    $_______
  822.           Iowa, add sales tax (6%)                            $_______
  823.                                                    TOTAL      $
  824.                                                                -------
  825.           
  826.           Name: _________________________________Phone:________________
  827.           
  828.           Address:_____________________________________________________
  829.           
  830.           Address: ____________________________________________________ 
  831.           
  832.           City, State, Zip: ___________________________________________ 
  833.  
  834.           Disk size       5.25       3.5
  835.           
  836. Where did you find the program?  __________________________________
  837.  
  838. Any Suggestions?
  839.       
  840.           
  841.           --------------------------------------------------------------
  842.  
  843. -------------------------------------------------------------------------
  844. CREDIT CARD ORDERS -
  845.  
  846. You can order with MC, Visa, Amex, or Discover from Public (software)
  847. Library by calling 800-2424-PsL or 713-524-6394 or by FAX to 713-524-6398
  848. or by CompuServe Email to 71355,470. You can also mail credit card orders 
  849. to PsL at P.O.Box 35705, Houston, TX 77235-5705.
  850.  
  851. Please mention the product ID number for MaxFind which is 11357.
  852. The cost from PsL is $21, you will receive a disk from Stan Peters.
  853.  
  854. THE ABOVE NUMBERS ARE FOR ORDERS ONLY.
  855.  
  856. Any questions about the status of the order, refunds, registration
  857. options, product details, technical support, volume discounts, site
  858. licenses, etc, must be directed to Mr. Peters at 515-472-0696.
  859.  
  860. To insure that you get the latest version, PsL will notify us the day of
  861. your order and we will ship the product directly to you.
  862. -------------------------------------------------------------------------
  863.